home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / misc_pto / addr / addr.doc < prev    next >
Text File  |  1989-06-26  |  4KB  |  81 lines
  1. Addr-Break
  2. ----------
  3.  
  4. This is a Public Domain program intended to help find some nasty bugs.
  5. It must be used with a debugger like DEBUG, so, some knowledge of assembly
  6. language and a debugger are necessary.
  7. The program can generate an INT 3 to break from infinite loops, or, if
  8. the keyboard no longer responds, at least show the address where the
  9. running program was executing before the crash.
  10. The only active keys are <CTRL>, <ALT> and <SHIFT>. Pressing <CTRL> and
  11. <ALT> simultaneously will pop up the address window, where you can read
  12. the Code Segment and Instruction Pointer.
  13. Press <CTRL> <ALT> again to close the window.
  14. By holding down <CTRL> and <ALT> and pressing the right or left <SHIT> key,
  15. you can move the window in the corresponding direction. Release the <SHIFT>
  16. key before releasing <CTRL> or <ALT> or you'll activate the breakpoint.
  17. Addr-Break works only for video page 0, but can run both in mono or color
  18. modes.
  19. An amazing capability is that you can generate a breakpoint anywhere, even
  20. in ROM!
  21.                           ----------- O -----------
  22.  
  23. Limitations: if the user program writes data to video while Addr-Break's
  24. window is open, the screen contents 'under' the window will be lost. This is
  25. not a bug, rather, I decided to do it this way for speed purposes.
  26. Addr-Break works using the timer TIC, so, it can't take more than 1/18 of a
  27. second to refresh the screen. Also, if the bug you're chasing trashes the
  28. interrupt vectors, Addr-Break will also crash.
  29. If the user program misuses INT 8, Addr-Break will not work correctly.
  30. The breakpoint capability is useless in cases where the user program takes
  31. INT 3 for it's own purpose. There are many programs that make use of INT 3,
  32. specially copy-protected software that tries to make a nightmare of debugging
  33. sessions, so, don't expect Addr-Break to work always.
  34.  
  35.                           ----------- O -----------
  36.              
  37. You'll find a simple program named 'CRASH.COM' which crashes the machine for
  38. a long time. It's a simple assembly language loop that executes thosands of
  39. times, enough to stop even a fast 386. It's intended as a demo, to show the
  40. capabilities of Addr-Break. If you run CRASH.COM alone, you'll have to
  41. reboot, or wait a LONG time.
  42.  
  43. This is how it works:
  44.  
  45. * Run ADDR.COM
  46. * Use your debugger as always and try debugging 'CRASH':
  47.   DEBUG CRASH.COM
  48. * at the '-' prompt type 'G' to run 'CRASH'
  49.   DO NOT PRESS ^C or ^BREAK or the brakpoint will be useless.
  50. * Press (and hold) <CTRL> <ALT>. You'll see the execution address.
  51. * Keeping <CTRL> down, release and press <ALT> until you reach the address
  52.   where you want to break the running program (you can also hold <ALT> and
  53.   toggle <CTRL> for the same result).
  54. * When you have the correct address frozen in the screen, press (and hold)
  55.   any of the two <SHIFT> keys.
  56. * Release <CTRL> and <ALT>, then release <SHIFT>.
  57. * continue debugging as always or type 'Q' to quit to DOS.
  58.  
  59.                           ----------- O -----------
  60.  
  61. Addr-Break is not a demo, you can actually use it to DEBUG any of your
  62. programs eliminating the need for hours of tracing.
  63. Addr-Break is Public Domain, however, a small donation of U$S 10 or less
  64. would be greatly appreciated. If you like this program and find it too
  65. difficult to send money, a postcard will do fine.
  66. Please do not modify Addr-Break, use it as it is. If you upload it to
  67. another BBS please send the original ADDR.ZIP.
  68.  
  69. If you found Addr-Break useful and have a bright idea for a small assembly
  70. language routine you'd like me to develop, feel free to contact me.
  71.  
  72. E-Mail: Telecom/Net, 011 541 764-4189 (Argentina) Fido Net 4:1200/112.0.
  73.         2400/1200/300 baud, N,8,1, BELL/CCITT.
  74.  
  75.                                             Pablo Montoreano
  76.                                             O'Higgins 1563 2nd "B"
  77.                                             (1426) Capital Federal.
  78.                                             Buenos Aires
  79.                                             ARGENTINA
  80.  
  81.